home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / show / hamdctv.lha / HAMonDCTV.doc next >
Encoding:
Text File  |  1994-01-01  |  4.0 KB  |  100 lines
  1.  
  2. HAMonDCTV version 1.00, copyright 1993 Nicolas Dade. All Rights Reserved.
  3.  
  4. Permission is hereby granted for non-commercial duplication and
  5. distribution, and for distribution by BBSs which do not charge
  6. for downloads, and for distribution in disk collections which
  7. charge a nominal fee per disk. This is not shareware.
  8.  
  9. NOTE: This program is of very little use if you don't own a DCTV
  10. display device. In addition to a DCTV, you must be using
  11. workbench version 2.04 or better.
  12.  
  13. NOTE: the dctv.library is required by HAMonDCTV but it is not
  14. included in this archive. If you don't already have it, the
  15. easiest place to find it in on aminet in the file
  16. "gfx/misc/dctvlib3.lzh".
  17.  
  18. HAMonDCTV displays ham6 and ham8 pictures using the dctv display
  19. device. Therefore it does _not_ require the AGA chipset to
  20. display ham8 images. Yes, now you too can look at people's
  21. raytraced ham8 pictures on your non-AGA but dctv amiga.
  22.  
  23. Images are automatically shrunk to fit the screen (unlike the
  24. dctv software), and the final dctv screen image can be saved to a
  25. file. The shrinking is done by skipping columns or rows of
  26. pixels, whic is fast but which can result in some details in the
  27. original image missing completely from the dctv image if the
  28. details resided in only those columns and/or rows that where
  29. skipped. This doesn't happen often with raytraced images and
  30. photographic images, but it can happen with computer drawn images
  31. with thin vertical and/or horizontal lines.
  32.  
  33. Usage is from a shell interface only.
  34.  
  35. To just display a ham6 or ham8 image,
  36.  
  37.   HAMonDCTV ham6_picture_file
  38.  
  39. The default display uses an interlaced 4 bitplane display the
  40. size of the text overscan (which is the size of your workbench
  41. screen's visible area). In addiiton the image is filtered (as in
  42. the FILTER option in the dctv load requester) as it is loaded.
  43.  
  44. These behaviors are modified by the parameters 3PLANES, NOLACE,
  45. NOFILTER and OVERSCAN. The first three are just flags. OVERSCAN
  46. should be followed by the abbreviation for the overscan mode you
  47. desire. The choices are
  48.  
  49. NOM (Nominal) For your screen modes, this is 640x400 or 640x200.
  50. TXT (Text) Every bit of the screen is visible. Set via preferences.
  51. GFX (Graphics) The screen reaches the each of the display. Set via
  52.     preferences
  53. MAX (Maximum) The screen is as large as the hardware will allow, while
  54.     still allowing all other DMA to take place
  55. VID (Video) The screen is as large as the hardware will allow, without
  56.     caring about doing anything but displaying the image. Video is,
  57.     ironically, even larger than maximum.
  58.  
  59. BEHIND tells HAMonDCTV to open it's screen behind others, so that
  60. you do not have to see the image loading process. The screen is
  61. brought to the front once the image is loaded.
  62.  
  63. In addition to displaying ham6 and ham8 images, HAMonDCTV will
  64. also save the dctv image. To do this, specify
  65. SAVEAS=dctv_image_file.
  66.  
  67. Typing "HAMonDCTV ?" and then giving a second "?" at the prompt
  68. will show the internal help text, which sumarizes this doc file.
  69.  
  70. One last example:
  71.  
  72.   HAMonDCTV testham8.pic 3PLANES NOLACE OVERSCAN=NOM SAVEAS testdctv.pic
  73.  
  74. will display the picture testham8.pic in a 640x200x3 bitplane
  75. screen, and save the dctv image to the file testdctv.pic.
  76.  
  77. The loading or saving process can be aborted by pressing ESC or
  78. CTRL-C (either by sending HAMonDCTV a ctrl-c signal via the break
  79. command, or by pressing ctrl-c into the image's screen (well,
  80. window, actually, but you can't see the window very well).
  81.  
  82. Once the image is displayed, HAMonDCTV waits for the use to press
  83. any of SPACE, RETURN, Q, ESC, CTRL-C, or the right mouse button,
  84. and then it exits.
  85.  
  86. I wrote HAMonDCTV in three days in order to learn to use the
  87. dctv.library, in preperation for my real christmas holiday
  88. project, a jpeg -> dctv displayer. Therefore I'm not likely to
  89. add support for 256 or fewer color pictures, nor any other bells
  90. and whistles. If you would like to do this yourself, feel free to
  91. email me. The source is 1950 lines of assembly.
  92.  
  93. I am
  94.   Nicolas Dade
  95.   405 W. Delaware
  96.   Urbana IL 61801
  97. or
  98. -Nicolas Dade / n9rzb / nicolas-dade@uiuc.edu
  99.  
  100.